Share your Sass with Sache: A quick guide

Course- Sass >

Sass has really come a long way over the years! I’ve been an avid user of Sass since the days of the indented :property value syntax. One of the things that has always bothered me about Sass is that there has never been an easy way to find Sass libraries and extensions. Sure you can do a search on Google but there are no guarantees that you’ll hit upon the right combination of keywords to reveal the right library for a particular purpose.

Sharing Sass tools

The simple 2-step process makes it painless to add your extension so that others can find it and use it! There is one small caveat: to add your project to Sache you must have your code checked into a public GitHub repository. Not familiar with GitHub? No problem.

If you need help creating a GitHub repository, check out these handy guides from the GitHub help site:

  • Set Up Git – a guide ideal for people just getting started with Git.
  • Create a Repo – a simple introduction to creating a repository on GitHub.

Here’s how to add your project to Sache once it’s on GitHub:

  1. Add a sache.json to your repository that looks something the following. Be sure to customize it for your project:

    {
      "name": "project-name",
      "description": "Description of project",
      "tags": ["ui", "buttons", "etc"]
    }
    
  2. Visit the Sache website and click the “Add Your Own” button at the top and enter your GitHub project SSH URL. If you need help finding your SSH URL it’s in the sidebar of your GitHub project’s page:

    Where to find your SSH URL

That’s really all there is to it! Your project will now appear on Sache.

Finding Sass tools

With every Sass tool added to Sache comes the data we need to let you sort by stars, title, author, etc. If you want to filter the results, simply click the header of the table column you want to sort by or click on a tag or author name.

You might already know exactly what type of extension you are looking for. In that case, use the search bar in the upper right of the page to enter keywords, author names, extension names, etc. We’ll show you what we find that matches your terms.

Each tool inevitably links over to a GitHub page where you can find installation instructions and documentation in the README file of the repository.